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meter iS COmirisea Of two computer progrars which were 
written in the C programming language. The main program 
Perm nes them@aput TO the filter on a character by character 
micis, and  prevides twe casic capatilities which are not 
Seren viy avatiable ain Wa5S. fhe first is the ability to 
eemueeOG. cCi@atve cilesSs qnd the second is a facility fer 
translating abbrevietions (macros) into Y&S commands. The 
macres ia ier ude =="aINes “whlch dre substituted into 
Moriadles in the commands as they are sent to #25. The 
eecard  pregram bufiers the output from WES as directed ty 


toe Main program to avoid an interleaving of outrut when a 
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IT. BACKGROUND 


Me OBJECTIVE 

The objective or this thesis was to develop a filter 
program for the Warfare Environment Simulator (WES). It was 
envisioned that the trogram would continuously examine the 
Characters which were being typed in to determine if a 
predetermined set of characters (a String ) wes present, 
mamei: sO, to perform some corresponding, and also 
eredetermined function. Additionally, the program would be 
SPapable of bufltering output from WES in the event that 
output from some other process is being displeyed on the 
Beaigeniai, “Or Example, this would allow for the use of an 
editor, since the ocutput from WES could be saved, and later 
displayed on the terminal when the editing sessiou was 
Sommpleted. fThis objective was met in the manner descri hed 


moe tae following section. 


B. INTRODUCTION 

Iteachieving Une stated objective, two major questions 
had to be answered. The first question was What tunctions 
mara ve mMOoSt uUSeézul in the implementeticn of the filter 
concept ? Those who were most familiar with the operation 
Sieve were the least concernea about functicne which would 


Make it easier to use: as usual, once a syster has already 





been learned, almost by definition its use becomes easy. On 
the other hand, since the majority of: those wno have tried 
to use WES have been initially overwhelred by its 
Semclexity, tney provided many suggestions as tO what 
Capabilities the filter program should provide. The second 
question was How will the program determine when a 
particular function is to be performed ?, or Similarly, 
“How will the user indicate that a function is to be 
performed ? The answer to this question will de eddressed 
ieenst. 

To enable a user of the program tc distinguish between 
input to WFS end @ commana to the filter program, a 
special character (the $ ) was chosen. It must precede any 
meput which is to be interpreted by the program. for 
example, if help was typed iz, it would be passed through 
mee filter to WES without any action being taken by the 
program, while $help weuld cause the program to display 
the help file without sending any characters to Wrs. 

Answering the first question was a much mere difficult 
mck. ine answer liés in the intersection of two lists of 
eerppaclilities - a list of what would te most useful to 
meeement, and a 11st cf what is reasonable to implement. 
The adjective reeasonabie in this context means feasible in 
Menms Of the limitaticns imposed bv: (1) the programming 
mhatmgvuage being used Cae cab (2) the operating system (UNIX) 


and the standard routines it has access to, and (3) the time 


mcileaple TO Write the program or subroutine. All of these 
mae tors were taken into account when the filter concept was 
develcped and implemented. 

A review of the capabilities which were common to the 
mer SUSeGeStl ved iM a decision to include the following 
mmctions in the filter program: 


Mmeenan GCditing Capability tor reviewing old files, or 
creating new ones. 


fea means Of identifying certein dvrief strings of input, 
ec iaa to wcminucad mOnewconplex series of Characters to 
WED . 


Sea mechanism for substituting argurents provided as invut 
tor variables in prederined wW3S commands. 


4. A default mode ot operation in which input previded to, 
Scewelll) as GQutpuYy trom, wAES occurs as it would if the 
filter program were not being used. 

A detailed description of how these functions are performed 


mmmeooe topic of the next section. 





Memeo SLR UcClURe AND DESCRIPTION 


A. THE MAIN PROGRAM 
fee ceneral 

The main progrem receives input from the keyboard, 
meeexs tOr the special character, and either passes the 
other characters to telnet or responds to the Special 
Character strings as it they were commands. The special 
character for this program is the dollar sign (S$ ). A 3$° 
causes the program to compare the characters immediately 
mollOWing it to a list of strings of characters which 
mammespond tO subroutines which are to be performed. I[f the 
miout string does not metch a string in the list, an e@rror 
ressage is generated and nce action is taken. 

These two modes ot operation, as indicated in tne 
source code, are (1) the default mode, and (2) the ‘call 
Subroutine mcde. In the former, ell input cherecters are 
Pent to t@inet, with the echo (a copy of the character on 
the terminal screen) bdeing provided by the remote host. In 
Pierce hweoie 1.oput Characters are used to control the 
Meeeram, Which performs varicus *suncticns which are not 
Otherwise available while running the WES program. These 
functions include listing tne available files, invoxing the 
editor, and expanding abbreviations (later referred to as 


macros) intc standard weS commands. 


et 





The filter process was designed to be file driven . 
marie Wost tart, tae text which is required tor display in 
phe Main prograr is contained in separate files which are 
@mened, read, and copied to the terminal. This allows for 
Memeo ex tT LO be €asily chenged as mecessary, and results in a 
mmorcer program. This tradeoff is in favor of both 
memmobicity, and tflewibility for future expansicn or 
meer ication.. 1% Should 5e noted that this flexibility does 
not extend to changing the ménu text without changing the 
Switches in the main program which control the response of 
moe crogram to the selection of an ortion. 

Aside from the subroutines, the overall program is 
divided into three distinct parts (Figure 1). The main 
program controls the overall filter precess. It alsa causes 
am asynchronous program to be executed which receives the 
meoput from telnet (which is the output trom WES in this 
Gase), and either sends it directly to the terminal or 
pores it while cther inzormation is hneing displayed. This 
buffer program is discussed in more detail in section II C. 
The third part of the program is the telnet vorocess, which 


Mell be discussed in section I! DC. 
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2, «the Subroutines 
The subroutine init() executes the actions which 
are required to begin using the program (Figure 2). The 
meet Significant of these actions are as follows: 

1. Reading the macros and their WES @quivalents into an 
Brey sO udat the prog@ram can frapldly determine if an 
miub ctbring iS 9a Valid rFacro, and if it 15, Output the 
WES command. 

za. Determining the type of terminal that is being used, so 
that the proper (either line or full screen) editor can 
pe called, if required. 

See Determining whether the program will be uséd with telnet, 
Snecor trdlning on the cacrabilities and oOpé@ration of tne 
program. 

The subroutine which controls the display and 

Bee ection of options is “menu()’. <A text file Containing 

toe menu of options is displayed, and a number corresponding 

to the option selected is entered (Figure 3). The 
appropriate subroutine is then called. After an option has 
meen completed, the wenu is displayed again, and another 
molce May be made. Returning to the standard WES input 
mode is the last option on the renu. 

The following cptionse are available in the menu 

(with the exception ot 4 which has not been implemented): 

Mmeraiving an €xisting file, cr creating a new file. 

Pesplaying the current list of filenares. 

Nditing the list ot macros and their WES equivalents. 

meeparing dan order for input to WES. 


merasplaying tne current list of orders. 
- Returning to the standard WES input mcde. 


None WG Mr 


i4 
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[ THE FILE mac.text 1S OPENED AND READ INTO ] 
[ THE ARRAY “mac[]” IN THE MAIN PROGRAM ] 


tWietriaqgnr sacl eoOoele Pol 1962 
WHAT TYPE OF TERMINAL ARE YOU WORKING ON ? 
_ Won Arbor. 


mevigital Viv i¢@O. 
DUetmomor Tektronix. 


CA ND 


seca deaeee | se Cimy eae OF  Gaae eap 


1 <---[ A “1 WAS TYPED IN HERE TO INDICATE THAT ] 
[ THE TERMINAL BEING USED WAS AN ANN ARBOR ] 


WELCOME - You have the following options: 
1. Telnet to Topvs2ed and log in automatically. 
Zier oO anotner Germinal itn ae’ C-2 Lab 


Gimimarily fOr trainine On this program) . 


eer ee OR 2 


2 <---{ A 2 WAS TYPED IN HERE TO INDICATE THAT ] 
[ PROGRAM WAS TO BE USED FOR TRAINING ] 


[ THIS RESULTS IN A CALL TC “c2LabLink(}" } 
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[ TYPING “S$” AND A CARRIAGE RETURN CAUSES ] 
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MENU 


omc | A 
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Q 


[ 
[ 
[ 0 
[ 
l 
[ 


THE FOLLOWING MENU TO BE DISPLAYED ] 


41 = Yow"have the following options: 


. Review/Edit an existing file. 


See the current list af filenares. 
Review/Edit the current macro list. 


ane Pare oc 0 eOrge fr. 
see tUhe® current list of orders. 


@uit (returo to standard WES input mode). 


2 eee SiMe aets fl ty. 0, OF Oe TY 


"6° TYPED HERE CAUSES THE FRCGRAM TO ] 
RETURN TO THE STANDARD WES INPUT MODE 1] 


PTION 4 HAS BEEN INCLUDED BOTH HERE AND 
IN THE SOURCE CODE TO DEMONSTRATE AN 
PTION WHICH MAY BE ADDED TO THE PROGRAM 
IN TEE SUTURE, AND AS AN EXAMPLE OF HON 
FASILY A MODULz MAY BE ADDED TO THS 
PROGRAM 


mM <---[{ THIS 1S THE OPERATING SYSTEM PROMPT FROM 


[ 


TOPS2@, wHICH IS DISPLAYED A¥TER OPTION 
‘6 HAS BEEN SELECTED 


igure 3. SUBROUTINE “renu()” 
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es 


— — —._— oe oe am =e¢ es am —_ «= 
li ee ee ees ee eee ee Oe — ——_ am — —m . a oe ee 





[mens 4 dnd S have veen included ln the menu as ean example 
maa POTENtial dadr@a fOr expending the program beyond its 
mepabilities as it is currently written. If option 4 (crder 
preperetion), is selected, a message is returned stating thet 
meemomtron 15 WOt lmpiemented yet. Orvtion 5, however, does 
list the files in the directory which end in .ord ; this 
Mem C€asily pve changed to any ending which would readily 
meemtity the tiles containing standard groups of orders ‘for 
mut to WES. This will be discussé@d in rore detail in 
Chapter IV. 

The most complex series of subroutines begins with 


"macro() (Figure 4). This tamily ot routines includes 


Mracro() , next() , xlate() , and sub({) . They are used 


MemaccOmplish two closely related tasks, both of which ére 
controlled by ‘macro()’. 

Pee Est bask 15 the Substitution of @ ¥ES command, 
Or a series of WES commands fcr an abbreviation (macro) 
which is defined ana entered into the file mac.text.. This 
meee may be. changed at ary time by choosing menu cption &. 
Meee tile is stored in an array in the@ trcgrar to facilitate 
a rapid search and translate precess. Tc expand a simple 
macro, a S Pomeeuvered , .Ollcwed oY the mecro and a 
Serrieage return. fr the macro is to be used at the 


Meeinning (or in the riddle) of a sentence, the macre is 


(D 


ended with the character escape. 
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[ “macro()” EXAMINES THE INPUT FCLLOWING A 
[ "$" IF THE INPUT DOES NOT CORRESPOND TO 
[ 


A PREDETERMINED FUNCTION WITHIN THE. 
PROGRAM SUCH AS help() OR quit() 


+--+ 
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| | 
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SUCCESSIVE CALLS TO NEXT ARE REQUIRED TO 
DETERMING IF A MACRO EXISTS WHICH 
MATCHES THr CHARACTERS WHICKR ARE BEING 
TYPED IN. 


If A CHARACTER IS TYPED IN WHICH DOES 
NOT MATCH A MACRO IN TEE CURRENT LIST, 
AN SRROR MESSAGE IS DISPLAYED 


‘cam 3S eS eee 
i Jet ett 


THE ERROR MESSAGE — NOT A VALID MACRO 
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Figure 4. SUBROUTINES “macro() AND next{) 


f-> 
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ee ee eee wee ee 
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lips Causes the expansion of the macro to be sent to WES, 
Mee it is net followed by a carriage return. This type of 
expansion is useful for sending commands which are 
meecuentiy used during the conduct of a game, especially 
Since a new macro can be adaded to the file while the game is 
meeprogress. 

The second task is an extension of the first in 
meecn da macro with arguments is @xpanded intc one or more 
Meo ccmmands. aAtte@r the macro and its expansion are found 
Mmeeune array, the arguments are substituted into their 
appropriate places in the ccmmands as tney are sent tc WES. 
For example, if S$atk.a7(aimitz,4,flti) is entered, the 
following actions are taken. ‘Macro() is called as soon as 
enough characters are entered to aetermine that the input is 
Mmemeea request for one ot the programs standard routines, 
meee help() . In this case, the letter a is sufficient 
tO make this decision. Successive calls to next() are 
made as required to match the string cf characters as it is 
Mame typed in. This serves two functions. First, no delay 
Mmeerequired to locate the mecro and send the WES equivalent. 
second, as soon as a Character is typed in which causes the 
Pemrnue of cheracters to te different from the list of macres 
in mac.text., an error message ("NOT A VALID MACRO’) is 
feeepidyed and the pregram returns to the standard WES input 


mode. 


ites, 





Atter $atk.a7(nimitz,4,fltl) is entered, it must 
meesollowed ty a Carriage return cr an eScape character. [In 
either case, the argunrents (nimitz, 4, and fltl1) are 
mmostituted intc the apprepriate places in the ccmmand which 
Memesiett to WHS. in this cas@€, the outrut to WES would bde 
“FOR NIMITZ LAUNCH 4 AVE FLT1 122 249 1@0€°. Since this is 
4a macro with arguments, the substitution and outout to WES 
is accomplished by ‘sub() . If the macro did not have eny 
Secuments, the translation and output would heve béeén 
accomplished ty xlate() (Figure 5). As menticned earlier, 
tollowing a macro with a carriage return causes a carriage 
return to be sent to WES, wnile ean escape cnaracter allows 
Mmeamicadcro Expansion to be used ia the context of a WES 
command . 

“Kdit() is the routine which provides the 
Mermerity tOwmeview an eristing rile or to create,a new 
mere. oince the type of terminal being used is determined 
mel Menic() , PiemCcOnnespOlulteunybe Of editor can be called. 
The distincticn between the different types of terminels 
fet be made by the program, since the UNIX operating system 
is not capable of making the distinction on its own. After 
entering “edit() , the name of the fiie which is to be 
edited must be entered. Since the program examines every 
Character which is typed in, if a mistake is wade in typing 
Meroe file name, nO provisions exist for deleting 


Mearacters which have been typed incorrectly. To instre 
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miagt this 15 HOt a croblem, the prograr asks for a 
verification (a ‘yor on) of the name which has been 
empveread. Once in the editor, the progremr is no longer 
Examining the input, and the editor is used as it normally 
would be. AS a minimum, this ré€quires the user to Know whet 
meommand must be Enterea in order to exit fromr the editor, 
Since the program cannot be of any essistéence. Once the 
meeebineg cession is complete, tne renu is displayed and 
emother selection must be mede. Although the file 
containing the macros may be edited in this fashion, a menu 
meron has been provided to accomplish this directly (Figure 
SB) . 

IMecmoccOnomOuL TON On LIe menu 1S tC €lisplay the List 
of filenares which are available in the directory which was 
Mmeed tO run the filter program©r. isclay is intended to 
provide a list of files if e particular file is to be edited 
Or reviewed, but the exact name cannot te remembered. It 
Seeecents the file nares in a column formet, so that all the 
mmees in most directories will be availatle on the screen at 
one time (Figure 6). To return to the menu, any character 
may be typed in. 

Pemorevicusly mentioned in the discussicn on 
“edit()", the subroutine “rvwMacro()” autometically calls 
the macro expansion file ( mac.text ) into the appropriate 


editor (Figure 6). ‘RvwMacro() is called by selecting item 


eon the renau. This routine was included as an explicit 
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[ INPUT THE NAME OF J] f[ AN EDITCR IS INVOKED } 
{ THE FILE 10 BE (Pee rC REC CRRE SPONDS TO} 
[ REVIEWED OR ieee Pee OM SER INAL | 
[ CREATED jet PENG Us aD ] 


[ A COMPEETE LIST OF THE FILENAMES WHICH ARE 
{ AVAILABLE IN THE DIRECTORY BEING USED ARE 
[ ior leavin IN AeCOLUMN: sORMAT 
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THE FILE ‘mac.text. WHICH CONTAINS TEE LIST 
OF MACROS AND THEIR WES ZCUIYVALENTS IS 
CALLED INTO THE EDITOR WHICH CORRESPCNDS TO 
THE TYPE OF TERMINAL BEING USED 
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Figure 6. SUBROUTINES edit({} , display{) and rvwMacro() 
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Meron simee the macro Expansion capability is the most 
Mewertul G@ption aveilable in the program. Jn this light, 
jes ability to repidly add to or cherge the 11st of macros 
marte the WES trograr is running should trove to be a 
desirable feature. 

As mentioned earlier, the subroutine orderPrer()™ 
moenot yet implemented, but has been included for the 
following reasons. The préparation of a series of WES 
commands, referred to here as an order, was suggested eS a 
mr teature to pe add@€ad to the Erogran. In the context 
of WES such a series of comrands would be called a plan. 
jes routine is E€nvisioned to usé a menu, from which small 
Means would be s@lected and comoined to form a complete 
eam. ithe overall plan would coOutain standardized control 
Characters, which would be replaced by arguments in a 
routine similar to sub() . The plan could then be typed 
Seeeeor Cdited prior to b@€ing sent to WES. Although this 
Mescription 15 somewhat limited, it should provide both en 
Pemeeandation of the concert and a framework on which to build 
if it is to be implemented. 

MPewSELECYLOmeaqt ThE Next item On the menu causes 
“pywOrders() tc pe executed. This routine is sirilar to 
Bemspiay() , in that it lists the evailable files of a 
meemeaio type, it this case files which contain orders. 
These files are currently assumed to have e file type, or 


mmeeix, of  .Ord . This suftix can be easily changed within 
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the program to one which is more easily remembered by the 
moer. A series of suffixes can also be entered in the 
meoeram if a more general listing of order files is desired. 
The next subroutine is tnTops2¢()', which verforms 
Mmriioer of TUuNMCtiONS if The Option to use telnet is chosén 
(Figure 7). First, it requests that twe orecesses be 
initiated - telnet and ‘readTN . The output from telnet 
(WES) is sent te the background program, readTN. This 
connection is established using the UNIX pipe function (}). 
However, the ccnnecticn between tne filter program and 
Telnet is created in tke program using ropen() . The vipe 
facility can not be used by the filter since a pipe sends 
eee OL the output of the first process to the second. For 
example, the pipe functicn would cause the menu to be sent 
moetreinet, wkich obviously would not be desirable. 
“Popen() creates a file descripter, which is essentially a 
Menor the input Side of telnet. Using the file 
Mmescriptor, selected output can be sent to telnet, while 
Other informaticn is displayed cn the terminal screen. 
Pom nDemotscusseq MOrTe thoroughly in Section D of 
this chapter, tnTops2@() also selectively adiusts the 
Merminal wodes, which would otherwise cause tne keybcard to 
become inactive. It then sends the file “trTcps2@.text tc 
memmet. lhe tile contains tne commends to log in and to 
Meee running a cértain prcsram if desired. This is an 


meapple Of Why the orogram was dé€signea to be file dri’ 
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Figure 7. SUBRCUTINES tnTopsz@()° and “c3lapLink() 
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mor changing the program to be run efter logging in is 
easly accomplisned oy Editing toe Dromopsey tex. ener 


The help({)  reutine is the first of the stenaerd 
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routines which are available in the pregram (Figure 2}. 
consists of a file which is displéeyed on the terminal and 
mermrains Lie scbaSic tormats fOr input to the filter prograr. 
The file is displayed by typing in $ help or “$ ?°. The 
mumper of spaces occuring in the input string between words 
Mmomthis case is not significant, @.2@-., $ help and 
“Shelp achieve the sare result. However, this is not true 
mepeall input. For the most part, the input tc the program 
memin the formr of W2S commands, which are handled by the 
“default mode of the Pe O2 fa smadammas SCN sare sent dimectl, 
to telnet (WES). 

The second standard routine is quit() (Figure 8). 
It is requested in the same manrer as the help function, by 
typing in a dollar sign followed ty the word quit ('$ 
quit). Again, the number of spaces between the two words 
Mmnrot Significant. This routine is used to exit from the 
program, after logging off of the system at NOSC. Logging 
Mmealso Causes the telnet process to be terminated, as 
indicated by a message on the téerminai when this occurs. 
Meme ilver program could simcly te aborted at this point, 
Meme ver, the cutout buffer pregram would still be active, 
Mmm@emwGerminal modes would nov be set normally, and certain 


Bee GESCriptcrs would still be open. All the tasxs 
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[ TYPING IN $ quit CAUSES THIS ROUTINE ] 
{ TO PERFORM ALL OF TEE FUNCTICNS WHICH ] 
| ARE REQUIRED TO EXIT FROM THE PROGRAM J 


[ THIS SUBROUTINE PROVIDES A STANDARD ERROR 
[ MESSAGE ("NOT A VALID INPUT. TRY AGAIN ) 
[ WHICH IS USZD IN THE ERROR CHECKING 

[ ROUTINES TEROUGEOUT THE PROGRAM 
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Figure 8. SUBROUTINES “help()”, ‘quit()” AND “err(}” 
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Pequired tc correct these deficiencies are accomplished cy 
“quit()'. <A mesSage indicating thet the filter program is 
Mmemenenexitec Lroreriy 15 cisplayed as these tasks are 
Meecorplished. Feilure to use the quit routine will, eat 
pest, result in the display of an operating system rromrrt 
("%") with input from the keyboard being accepted, brt not 
echoed (displayed) on the terminal as it is tyred in. 

As previously mentioned in the description of 
“tnfTopsea() , a useful connéction between the filter program 
and telnet cannot be created using the UNIX pipe facility. 
Rather, the subroutine “popen() must be used (Figure 9). 
Meencreation of a2 pipe in this manrcer allows the progrem to 
send only selected output to telnet. Poper() returns a 
mre descrictor which, in this case, is essentially the name 
Steune inrut side of telnet. The output which is intended 
for telnet is then directed using this file descriptor. The 
procedure for properly closing this tile descriptor at the 
em@eno. the program is discussed in the following paragraphs. 
sufficient comments have been included in the source cede to 
provide more details as to exactly how popen() functions. 
memerurther description of this routine will be included 
here. 

Feebacenure(i.e., CORTECtL in 6 trogremming sense) 
Meegeaation of the tilter program must include a function 
which closes the file deScriptor ( fd ) which is created in 


vopen() (figure 9). This action is accomplished in the 
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CPlse Ue mOUn cheers USED IN LIEU OF TEE 
UNIX PIFE FACILITY TO CREATE A CONNECTION 
BETWZEN THES MAIN PROGRAM AND TELNET 


Wiettelomuo st) TO Dineer TES OUTPUT Of TEE 
euOG vate Letina AS Re CUIRED 


[ 
L 
L 
[ THE ROUTINE RETURNS A FILE DESCRIFTOR 
[ 
L 


eo OUTINMCMOALNHO BY oauit() TO 
l CLOSE THE FILE DESCRIPTCR WHICH WaS 
[ CREATED BY popven() 


| THE CTHER STANDARD LIBRARY RCUTINES WHICH 
[ IT IN TURN CALLS ARE NOT DESCRIBED IN 
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Figure &. SUBROUTINES “popen()” AND “pelose()” 





subroutine pclcse() . The call to pelcse() is a part cf 
the ‘quit() routine which has alreaay been discussed. 

Thee-ioal suorouline in the trogram i15 “err()” 
(Figure @). It has been included to sinmrlify ena 
mpomaardize the inclusion ot error checking mechanisms which 
mee .OUund throughout the program. Tne cnly function it 
merfOrms when 1t is co escumnomnoe wOULboUL Of ean Grror message 
ome toe terminal screen. 

Due to the fact that the sudroutines are file 
Meeven, all of tne files which are required for their 
operation must be aveilable in the diréctory from which the 
meoeram is executed. Ifa frile is not available, and an 
mmrempt is meade tO Open it, an error will result which will 
emo the ctrogram. This type of catastrothic error could be 
avoided, however, the program would be at rest nandicapred 
Meeerme adSence Of a particular file. For this reason, it is 
eeoumed that btpoth the program and the files which are 
Mequired to run it in its entirety will be aveilable. 
Semiilarly, the “peadTN~ Program must remain separate from 
mieemain program, and it too must be in the directory which 
Meevpeing used. A straightforward reans ot insuring that all 
mee orcegrams and tiles are accounted for is tc store them 
all on a tape, and to read the tape when first using the 
Mmmmer, OF When an erréer occurs because a required file has 


Been chenged or déleted. 





meee foe UNIX INTERFACE 

In general, the UNIX interface was the most 
mirabentforward concept to address in designing and 
Mmorementing the filter progrem. [In UNIX, essentially all 
moeas where input end/or output can occur are treated as if 
Hoey are tiles. To a great extent, this allows the user of 
BmcompuUter with a UNIX operating system to direct his 
attention to more important aspects ot rpregramrming. This 
concept is also found in the C programming tanguage, which 
is essentially the language ot UNIX, and which is the 
language in which this program was written. In C, 
Meowever, a distinction is made between the standard input 
and output (which are generally the keyboard and terminal 
Screen), e data file, end an active computer program 
(process), in that different formats must be used to receive 
meet from Or direct output to them. In most pregrams this 
femtd not be a Major concern, but this prograr by design 
requires the use cf all tnree formats. 

As described earlier, the main program causes a second 
program to be executed. This program is called readTN , 
and buffers the output from telnet (WES) as required. The 
PeaadIN program runs as a background vrocess, that is, it is 
eeecuted ty UNIX independently otf the main program. It 
Meee1ves its instructions by having access to a file which 
contains a flég, i.e., a character whose valve determines 


Memeoer the butzer is to ove active or not. The main prograr 
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also hes access to the file containing the flag, and by 
meomeine the Chdrdcter in the tile causes the buffer to be 
enabled (1°) cr disabled (2). 

The mein Lrogrem ealso requests that the telnet process 
fewinitiated. this opératicn is handled by a call to the 
UNIX operating system, and will be discussed in more deteil 


in the section on the telnet intertace. 


Peet He WES OUTPUT BUFYER PROGRAM 

This program, readTN , is essential to the cperation cr 
Mme rilte@r process. Without a ouffer, the output from Wes 
would be mixed on the terminal screen with the output from 
the process which the user hes selected. This would not 
have any effect on either wWhS or the user program, nowever, 
MmeewOuld be at best confusing to the user. An additional, 
and perhaps more sericus problem associated with 
interleaving the two outputs is that the user would be 
memreared tO divide SiS attention between ther. Buffering 
the WES output ellows him to concentrate on one issue at a 
memes aid tO be quickly brought up te date when the second 
mmecess is completed. 

One means Of controlling the output of the buffer is to 
fee the X-ON/X-OFF feature which is a part of UNIX. In 
maory, if the terminal page length ( pagelen ) is not zero, 
and flowcut is enanbled, the UNIX operating system will 


mamas the Output from WES or from the buffer program to the 





termrinal screen @ page at a time. To continue with the next 
maee, an A-ON, which is currently a “control-¢ , is typed 
[ree lois Character is interpreted by UNIX, but is not 

moms idered to be a Valid input to the pregram. Similarly, a 
“control-S can be used to Stor the output detore the end ot 
a page is reached. Rather than displeyling cone page at a 
time, a control-P can be used to enter the zoom mode , in 
mipmem Une OVLDULT dces not Stop at the end cf each page. The 
“control-F is a toggle, that is, a s€cond centrol-P 


mamces Che page lengtn to once again taxe eftect. 


D. THE TELNET INTERFACE 

Aernough not obvious in the source code, significant 
problems were encountered in implementing 6 program which 
provides input to the telnet process. The author of telnet, 
Dan Franklin of Bolt, Beranek, and Newman (BEN), Stated that 
Meedid not anticipate the use of a program to feed telnet 
when he wrote the telnet precess. He agreed that the input 
terminal becomes disabled when an atterpt is made to create 
mmreonmection beLwe@n a process and telnet. This terminal 
“lockup is caused by the telnet program, which changes the 
Beoemina! modes in such @ manner thet no input can be 
meme rated from the keyboard. This only occtrs when a 
program is used to create the telnet process. With tnis 
fact in mind, the program was written to reset the modes 


meerer tne telret orccess is created, so that the keytoard 





femepe reactivated. fnhis is accomplished in the filter 
crogram in the subroutine twnTors2e() . 

The main prcgrem creates telnet aes & means of connecting 
mie computer (a PDP 11/72) in the CZ Secure Comprter 
Menporatory to one of the virtuel machines at the Naval Oceéen 
Systems Center (NOSC) in San Diego. Aside trom the fact 
Mmeatvea different Operating system is being used after 
moeeing in to the system at WOSC, telnet itself is 
transparent to the user. It allows prcgrams and processes 
Mmomve run fron tne terminal as if a physical cennection to 


mae NOSC computer existed. 
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ine pimeose Of this section is to provide the user of 
mmm Ler Erogram wlth a concise, step-by-step set of 
imesotructicns to tollow lin becoming familiar with the filter 
Beoerans. this 15 Most G@asily accomplished by using the 
meainiing mode, since the cutpuvt of the tregram which would 
normally be sent vie telnet to WES can be displayéd on én 
memeacent terminal for easy reference. A copy cf a training 
mession On the filter program is found in Appendix 4A. 

Three steps must be followed in crder to begin training 
eeeeuce filter program. First, the type of terminal being 
used must be specified. This choice is made by simply 
Severing the number from the menu which corresponds to the 
beype Of terminal from which the program is being run. 
Second, a <2 must be entered to use the program in the 
Mmeerning mode. Finally, the letter which identifies the 
terminal to which the ‘telnet’ cutput is to be sent must be 
Metered sat thnoueh the letters which correspond to the Ann 
meoor terminals are shown on the screen, and alist of all 
Mmeeeole terminal identifiers 1s Shown, this mey not be 
Sereguate or simple erough to foilow. As an alternative, 
‘login on the terminal which is to be used to display the 
Sutrput, as well as on the terminal to be used to run the 


meener Droeream. On the Keytcerd cl the disvlay terminal, 
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type dpy yourname , where ‘yourname is the name used to 
meine bis will snow the upper or lowercase letter which 
morresponds tc the terminal, cr tty, immediately following 
the user name. Enter this letter when aSked for the tty 
you want to link to. Note that unlike many rrograms, the 
filter program reads every cheracter 4s it is typed in, ana 
meedrriage return 1S not required after an entry is made 
mimeiss it is Specifically asked for, or after Shelp , 
“$Squit., or S$macro is entered. Messages indicating that 
the link is being established, and that the keyboérd can 
meen be used will be displayed on the input terminal. 

To review the three basic types cf entries which cén be 
Made, enter "Ss ely followed by @ carriage return. It 
Should be noted that this and any other entry which begins 
meena S must end With a carriage return (CR), or, in the 
case of mécros, alternatively with an eScape character. The 
three entries, $ CR, $ macro CR, and $ quit CR cause 
the menu, a macro expansion, and termination of the prograr 
mem occur respectively. 

In the training mode, a simulated system prompt ( @) is 
Mero rayed On both the input and output terminals, since it 
WOuld be seen if telnet was being used. 

After reviewing the help file, input “$ CR to display 
mae menu cf cpticns. Step through each of the six items on 
moesmenu, returning to the Standard WES input mode dy 


magosing the sixth ovticn. At this time, the macro 
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PeooistoOn capavlrlity can be demonstrated. If a copy of the 
file “mac.text is not available, return to the menu, edit 
mae macro list by selecting item 5, and write down one or 
more macros. Fnter a $ followed by the macro (with 
arguments, it any) and end the input with a carriage return. 
iv ne Macro has been entered properly, no error méssage 
will be displayed, and the WES command(s) will be displayed 
meeepOoth the ineut and the Output terminals. Insure that the 
proper number of arguments, in the precper sequence, aré 

meee Tred. 

For easy reference, abbdreviaticns for the arguments have 
been included in each vacro in “mac.text’. For example, “s™ 
must be replaced by a Ship name, “n_ dby a flight name, and 
"#° by the quantity of items (e.g. F-14’s) which are 
@esired. It is anticipated that a paver copy cf the macro 
file will be nelpful and shoulda be available if a relatively 
Mmanee numter of macros are being used. The addition of the 
mevtvers to represent the arguments of a macro should also be 


meeorelishead when a new facro is add@€d to the list, to 


mesure thet it iS properly documented for future use. 


Cn 
ee) 





IV. CONCLUSICNS AND RECOMMENDATIONS 


Pee CONCLUSIONS 

The input and output ¢ilter program has been 
euecesstully demonstrated to be a vianole concept which 
interfaces weil with both the Wartare Environrent Simulator 
(WES) and the user. At the present time, the program has 
been tested with WES being run using several different, but 
meeadetermined scenarios. This epproach has been sufficient 
Mmomcetect and correct deficiencies in the pregrams which 
Make up the trilter, tut a recommendation for future testing 


and use iS made in the next section. 


Be. RECOMMENDATICNS 

ee ruvure Testing 

Po paciem Coe CrOeradm was Tested cn an incremental 

basis as it was developed, and significant changes were nade 
Memerasure that its use did not interfere with the conduct of 
peewee Wargare ifn any way, mere Extensive testing should bes 
accomplished as follows. The progrem shculd be used during 
@ truly interactive wargame, as orrosed to the wargames 
mmten have recently teen run in which essentially all orders 


Ze uc 


= 
-~ 
—_/ 


Moe entered from @ prepared Script. An interactive wer 
Would be Especially useful in evaluating the actual and 


movential value of the moSt powerful capability which the 





muoereme provides, 1.2. macro expansion. Any scenario in 
muon wne player is Torced to be active a great deal of the 
meme would be most useful in eccoOmplishing this evaluation. 

Ee OUtner Applications 

A general ooservation and recommendation for further 

Pies lems trom the tact that the input/output filter 
memeept has an unlimited number o* possible applicetions. 
moemceneral, int@ractive computer programs such as WES are 
money accessitle, but not tiexindble or easy to mredifv, if 
meewcan be Changea at all. The filter concept, on the 
ether hand, provides a mechanism fcr achievirg a wide range 
met bexa bility in terms of aids end options which can be 
Mmeoviaged walle remaining within the constraints on input 
imposed by an ctherwise inrfiexible prcecess. The general 
meeucture which has been presented here should serve as an 
meraguate DNaseline from which to dévelep many variations cf 


mime Tiiter frogram. 
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APPENDIX A 


Save te ROM THkh BI LTER PROGRAM 


MiemarmiacGm@edmrext 15 @ cepy Of the actual output of the 
mmereceprogcrar when used in the training rode. Tne only 
Slgnificant difference between the output shown here and the 
mast when the program 15 used witao telnet is as follows. 
In telnet, the eche is provided by the remote host (TOPSEQ), 


r 


#3) 


meme t DOLH the l1nput echo and the outErt from Wes appre 
in capital letters. 

iiemeqtles Of the menu Of ODtions which occur after it 
Mmeaisplayed the first time have been removed and replaced 


with "(MENU HERE)’. 
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